home *** CD-ROM | disk | FTP | other *** search
/ Java Programmer's Toolkit / Java Programmer's Toolkit.iso / applets / collectn / set.jav < prev    next >
Text File  |  1995-10-14  |  1KB  |  53 lines
  1. /*
  2.   File: Set.java
  3.  
  4.   Originally written by Doug Lea and released into the public domain. 
  5.   Thanks for the assistance and support of Sun Microsystems Labs, Agorics 
  6.   Inc, Loral, and everyone contributing, testing, and using this code.
  7.  
  8.   History:
  9.   Date     Who                What
  10.   24Sep95  dl@cs.oswego.edu   Create from collections.java  working file
  11.  
  12. */
  13.   
  14. package collections;
  15.  
  16. import java.util.Enumeration;
  17. import java.util.NoSuchElementException;
  18.  
  19. /**
  20.  * Sets provide an include operations for adding
  21.  * an element only if it is not already present.
  22.  * They also add a guarantee:
  23.  * With sets,
  24.  * you can be sure that the number of occurrences of any
  25.  * element is either zero or one.
  26.  *
  27.  * @author Doug Lea
  28.  * @version 0.93
  29.  *
  30.  * <P> For an introduction to this package see <A HREF="index.html"> Overview </A>.
  31.  *
  32. **/
  33.  
  34. public interface Set extends Collection { 
  35.  
  36. /**
  37.  * Construct a new Collection that is a clone of self except
  38.  * that it includes indicated element. This can be used
  39.  * to create a series of collections, each differing from the
  40.  * other only in that they contain additional elements.
  41.  *
  42.  * @param element the element to include in the new collection
  43.  * @return a new collection c, with the sameStructure as this, except that
  44.  * c.includes(element)
  45.  * @exception IllegalElementException if !canInclude(element)
  46. **/
  47.  
  48.   public Set  including(Object element) 
  49.                        throws IllegalElementException;
  50.  
  51. }
  52.  
  53.